Win Platinum

home *** CD-ROM | disk | FTP | other *** search

/ Win Platinum / Win Platinum.iso / util / wru311 / wru.doc < prev next >

Wrap

Text File | 1992-10-18 | 25.9 KB | 760 lines

WRU The Windows 3.1 File Finder v3.1.1 [Shareware] AT-Ware Dept. RJF 720 Sunrise Ave. #28 Roseville, CA 95661 Copyright 1992, AT-Ware All rights reserved Table of Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1 How WRU uses the screen. . . . . . . . . . . . . . . . . . . . 2 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Control Area . . . . . . . . . . . . . . . . . . . . . . . . . 2 File List Area . . . . . . . . . . . . . . . . . . . . . . . . 2 Drives . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Mask . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 File Size. . . . . . . . . . . . . . . . . . . . . . . . . . . 3 File Date. . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Archive formats. . . . . . . . . . . . . . . . . . . . . . . . 3 Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Beginning a file search. . . . . . . . . . . . . . . . . . . . 4 During a search. . . . . . . . . . . . . . . . . . . . . . . . 4 After a search . . . . . . . . . . . . . . . . . . . . . . . . 5 The WRU.INI file . . . . . . . . . . . . . . . . . . . . . . . 5 Selecting the drives to search . . . . . . . . . . . . . . . . 6 Entering a file mask . . . . . . . . . . . . . . . . . . . . . 6 Selecting an Archive format. . . . . . . . . . . . . . . . . . 6 Entering a file size . . . . . . . . . . . . . . . . . . . . . 7 Entering a file date . . . . . . . . . . . . . . . . . . . . . 7 Browsing a file list window. . . . . . . . . . . . . . . . . . 8 Searching the current file list. . . . . . . . . . . . . . . . 8 Screen Colors. . . . . . . . . . . . . . . . . . . . . . . . . 9 Keyboard Commands. . . . . . . . . . . . . . . . . . . . . . 10 Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Distribution . . . . . . . . . . . . . . . . . . . . . . . . 13 Ordering . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Introduction WRU is a Windows 3.1 file finder that has been designed to address the need of users with large hard disk and multiple thousands of files. WRU has the following features: * Multiple file list windows with 10,000 entries each. * Up to 13 fixed drives supported (no floppies, CD ROMS, or Tape drives) and they can be local or network drives. * All five of the popular compressed file types are supported (ARC, ARJ, LZH, ZIP, and ZOO). * DOS file searches can be turned on or off. * Full DOS wildcards * The search mask can contain more than one file name. * File size and date can be used in the search. * All user parameters saved in private INI file (no changes to any of the Windows INI files). * No files are placed in the Windows directory. * Each file list can be printed or save to a plain ASCII text file (with all search parameters). * The colors follow the colors scheme you selected for the windows desktop. * All control selections can be saved to the private INI file. How WRU uses the screen WRU follows the Windows MDI (Multiple Document Interface) format. Below the normal Title bar are the following sections. Menu Bar By using the menu and hotkey combinations you can control all of the operations of WRU without using the mouse. Control Area Below the Menu Bar is the control area which contains the status messages, edit controls, buttons, and latches used to control the operation of WRU. File List Area Below the Control Area is the file list area. This is where WRU will place the file list windows after each search. These windows can be maximized, reduced to icons, cascaded, tiled, or closed. Drives WRU examines your system and finds all of the hard disks available (even network drives) and displays them on the first row of the command area. Currently, a maximum of thirteen drives can be displayed (C - O). WRU does not display or access floppy disk drives, CD ROMS, or tape drives. Mask WRU allows you to enter a file mask to be searched for. You can enter one file name (WIN.COM) to be searched for or by using the DOS wild cards you can search for many files (WIN*.*). WRU also allows you to enter more than one mask for each search (WIN*.* *.PAS *.C COMMAND.COM) as long as the entries are seperated by a space and the total number of characters entered is less than 128. File Size If you need to locate files of a certain size you use the size edit control to enter the file size. Currently you can enter a file size with up nine digits. File Date You can also locate files by their date stamp. The date MUST be entered in the 'MM/DD/YY' year format. Archive formats WRU will search the internal directories of the five most common archive formats. The file extensions for these formats are: ARC ARJ LZH ZIP ZOO WRU also allows you to control whether the normal DOS files are included in the search with the DOS control. If you only need to see the matching files that are in one or more of the supported archive types you can use the DOS control to stop any DOS files from being included in the file list. Buttons The two buttons in the control area allow you to Begin a file search and exit WRU and return to the Program Manager. Each button has a hotkey combination associated with it, to begin a file search either click on the "Begin" button or press the "ALT-B" key combination. To exit WRU click on the "Exit" button or press the "Alt-X" key combination. Status The area next to the Begin and Exit buttons are where WRU displays the status information for the currently selected file list window. The first line contains the file mask used when that search was begin. The second line contains the drives and archive formats searched and the file size and date values used during the search. Beginning a file search Setting up WRU for a file search is a simple six step process: 1. Select one or more drives to search (at least one must be selected). 2. Enter or select the file mask to search for. 3. Select one or more archive formats to examine (at least one must be selected). 4. If the file size must be compared, enter a numeric value and select the size criteria value for the compare. If the file size is not important for this search make sure the size criteria is set to none. 5. If the file date must be compared, enter a date and select the date criteria value for the compare. If the file date is not important for this search make sure the date criteria is set to none. 6. Press the 'ALT-B' hotkey or click on the 'Begin' button to start the search. During a search Once a file search has begun a dialog box will be displayed showing you a running status of the search. The information displayed includes: The current drive and directory being searched. The name of any archive file matching a selected format (besides DOS) that is being searched. The name of any file that matches the search mask. The current count of matching filenames found. You can stop the search at any time by pressing the return key or clicking on the 'Cancel' button at the bottom of the dialog box. While a search is in progress all of the menu items, buttons, and latches will be disabled. When the search is complete or canceled everything will be re-enabled. After a search If a search has found at least one matching file, a new file list window containing the matching file list will be displayed in the file list area. You can use the mouse or the cursor keys to browse the list. If you wish, you can save the list to a disk file by pressing the 'F7' hotkey, or print the list by pressing the 'Alt-F7' hot key. If more than one file list window exists in the file list area you can use the commands found under the Windows (ALT- W) menu item to cascade, tile, arrange, close, or select different windows. The WRU.INI file When WRU begins executing it looks for the WRU.INI file (found in the same directory WRU.EXE is located) and configure the controls in the control area with the information stored in the file. The information in the WRU.INI file tell WRU the following: How many drives exist and which ones should be selected for searching. What values should be placed in the mask, size, and date edit controls. Which archive types should be selected for searching. If the WRU.INI file is not found, then a limited amount of default values are set and a new WRU.INI file is created with these default values: The current drive is selected for searching. The file mask '*.*' is entered in the mask edit control and selected. The DOS latch is selected for searching. The file size edit control is set to '0' and the size criteria is set to 'None'. The file date edit control is set to the current system date and the date criteria is set to 'None'. You can customize the WRU controls for your system and save the values to the WRU.INI file by pressing the 'ALT-F2' hotkey. From then on each time WRU is executed your preset values will be automatically loaded for you. You can force WRU to reload the preset values by using the 'F2' hotkey. Selecting the drives to search WRU displays all of the fixed disks that were found connected to your system on the first line of the control area. Each drive control is a latch that can be toggled on or off. If the latch is raised the drive will not be searched. If the WRU.INI file is not found then the current drive will automatically be selected. Entering a file mask You enter a file mask by clicking on the mask edit control (on the second row of the control area). File masks can contain the normal DOS wild cards (* and ?) and you can place more than one file mask on each line. Each time a new file mask is entered it is stored within the edit control and you can recall any of these by clicking on the down arrow on the right side of the edit control and selecting a different mask. If you use the hotkey (F4) to access the mask edit control the other entries will be displayed so you can use the cursor keys to move the high light bar to a different entry. To select an entry double click the left mouse button or press the return key. If the WRU.INI file is not found then the default file mask '*.*' will be the only entry in the mask edit control. Selecting an Archive format Telling WRU which archive formats to search is done with latches. If a latch is depressed any file with a matching extension will have its internal directory entries compared with the file mask. If the latch is raised then files with a matching extension will not have their internal directories examined. If the WRU.INI file was not found then the DOS latch will be automatically selected. At least one of the Archive formats must be selected before WRU will begin a file search. Entering a file size You enter a file size by clicking on the size edit control (on the third row of the control area). File size values can only be numbers (0-9) between 0 and 999,999,999 (you can enter the commas!). If you enter a value that is out of range an error message will appear. Each time a new file size is entered it is stored within the edit control and you can recall any of these by clicking on the drop control on the right side of the edit control and selecting the desired value. If you use the hotkey (F5) to access the size edit control the other entries will be displayed so you can use the cursor keys to move to the desired entry. To select an entry press the return key. Selecting the size criteria The size criteria values are stored in a drop down list box. Simply click on the drop control on the right side of the control or use the ALT-F5 hotkey. To select one of the entries either use the cursor keys to move the highlight bar to the new selection and press the Return key or place the mouse cursor on the new selection and double click the left button. Entering a file date You enter a file date by clicking on the date edit control on (on the third row of the control area) or by using the F6 hot key. File dates must be in a 'mm/dd/yy' format with or without the leading zeros (9/2/92 or 09/02/92). Once you have entered a date WRU will check your entry to make sure it is valid and display an error message if it is not. Each time a new file date is entered it is stored within the edit control and you can recall any of these by clicking on the drop control on the right side of the edit control and selecting a different entry. If you use the hotkey (F6) to access the date edit control the other entries will be displayed so you can use the cursor keys to move the highlight bar to a different entry. To select an entry press the return key. Selecting the date criteria The date criteria values are stored in a drop down list box. Simply click on the drop control on the right side of the control or use the ALT-F6 hotkey. To select one of the entries either use the cursor keys to move the highlight bar to the new selection and press the Return key or place the mouse cursor on the new selection and double click the left button. Browsing a file list window To browse a file list with the cursor keys you must either press the F8 hotkey or place the mouse in the list window and click the left button. If more than one file list window is in the file list area you can switch to a different window by pressing 'ALT-W' for menu access or by placing the cursor on the window and clicking the left button. The current file list window will set the Current Mask, Drives, Count, Archives, Size, and Date message areas (the two bottom rows of the control area) to the values that were used by that window for its file search. Searching the current file list You can search the current file list for matching values you enter. WRU uses a partial match method of searching which allows you search all of the fields displayed (directories, names, sizes, dates, and times) without using wild cards (if you enter a wild card character it will be searched for also). To begin a search simply press the ALT-F3 keys (or click on search and find) and you will be prompted for a string to search for. Once you have entered the string simply press the return key to begin the search. If a match is found the entry containing the match will be highlighted. If no matches are found the a small dialog box will be displayed telling you no matches were found. After the initial search (and at least one match was found) you can press the F3 to continue the search. This step can be repeated until all of the matching entries have been found. Screen Colors WRU uses the current system colors for all of the windows, controls and dialogs. The only colors that do not change are the reference colors used in the list windows to highlight directories and other file information. There are three fixed colors WRU uses: RED - To display the drive and path of the entries to follow. BLUE - To display compressed file names. BLACK - To display normal DOS files and archived file members. Keyboard Commands You can control WRU with your mouse or keyboard. To use the mouse simply place the cursor on the selected control and click the left button. To use the keyboard press the ALT key combination to select the proper menu item or use the following 'hotkeys': Alt-F File Menu. F7 Save list Saves the file list in the current list window to a text file that can be edited or printed. Alt-F7 Print list Print the file list in the current file window. You can select and setup the printer before you begin printing. F2 Load INI Reloads the default (or previously saved) initialization values back into WRU. The current values will be lost. Alt-F2 Save INI Save the current configuration for WRU to WRU.INI. The current configuration file will be saved as a backup. Alt-X Exit Exits WRU and returns to Windows. Alt-D Drives Menu. When using the keyboard, the drives can only be selected from the menu. The drives displayed will depend on the number of fixed drives (no floppies) found connected to your system. Alt-M Move to Menu. F4 Mask This command allows you to edit the current file mask WRU will use when looking for matching files. F5 Size This command moves the cursor to the Size edit control. Alt-F5 Size criteria This command moves the cursor to the Size criteria list box. F6 Date This command moves the cursor to the Date edit control. Alt-F6 Date criteria This command moves the cursor to the Date criteria list box. F8 List window This command moves the cursor to the current list window. Alt-E Examine This command allows you to select which file formats will or will not be examined for matches. Alt-S Search Alt-F3 Find After entering a string to be searched for, an initial search begins. F3 Find next Continues the previous search command. The search can continue until all of the matches are found. Alt-W Windows C Cascade This command cascades all of the list windows so that the title bar for each window is visible. T Tile Tiles all of the list windows so at least some part of each window will be shown. I Arrange Arranges any list windows that have been reduced to icons along the bottom of the main window. L Close all Closes all of the list windows. Help I Index This command displays an index of the available help topics. Alt-A About Displays the 'About WRU' box. To return to WRU simply press the Return, Space, or ESC key. Warranty With respect to the physical disk, AT-Ware warrants the same to be free of defects in materials and workmanship for a period of 30 days from the date of purchase. In the event of notification within the warranty period of defects in material or workmanship, AT-Ware will replace the defective diskette. The extent of this warranty shall be limited to replacement and shall not encompass any other damages, including but not limited to loss of profit, and special, incidental, consequential, or other similar claims. AT-Ware specifically disclaims all other warranties, expressed or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose with respect to defects in the diskette and documentation. In no event shall AT-Ware be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages. AT-Ware retains all rights to the WRU Package and the right to make updates to this package and its documentation without notification to the purchaser. This package is sold and distributed "as is". Distribution This package may be freely distributed as Shareware provided that no files are modified in any manner. The following files MUST be distributed with the WRU Package in their original unmodified form: WRU.EXE WRU.DOC WRU.HLP INSTALL.EXE INSTALL.INI README.ATW FILE_ID.DIZ The manner of distribution of this package does not relieve the final recipient of the package from the obligation to register this product with AT-Ware. Also, the recipient of the package MUST be made aware of the fact that this is not a public domain program and that they are required to register the WRU Package to be able to continue to use it beyond the 30 day evaluation period. The WRU Package must not be modified in any manner. You are not allowed to edit the messages that appear in the WRU Package with any kind of editor (word processor, text editor, or disk editor). Ordering The programs in the WRU Package are Shareware and are not public domain or free programs. The user is granted a free license to use the programs contained in the WRU Package for up to 30 days on one computer for evaluation purposes. To continue using any of the programs in the WRU Package after that time, the user must register the WRU Package. Registration When you register your copy of WRU you will receive the following: A disk with the latest version. (Shareware messages are removed). Printed documentation. 2 FREE Windows 3.1 Utilities. 1 Free major upgrade. Notification of updates. Discounts on future purchases. For $29.95 the user will be sent a registered copy of the entire WRU Package. The user is then granted a license to use the software contained in the WRU Package on any computer as long as only one copy of each of the programs in the WRU Package is ever in use at any one time. The user will also be notified of updates to the WRU Package (there may be a small handling fee). WRU Order Form Name : _______________________________________________ Company : _______________________________________________ Address : _______________________________________________ City : _______________________________________________ State : ___________________________ Zip : _________ Quantity Description Cost Total _______ Registration with : Latest Version. Printed documentation. 2 Free Windows 3.1 Utilities. 1 Free Major Update. Update Notification. $29.95 _____ _______ Shipping and Handling 2.50 _______ Foreign order Handling $10.00 _____ Total $_____ Please allow 6-8 weeks for delivery. Send this form (with payment in US Funds only) to : Richard A. Nichols AT-Ware Dept. RJF 720 Sunrise Ave. #28 Roseville, CA 95661 Thank you for ordering the WRU Package and supporting Shareware.